home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / bbs / zchss18c.zip / SBBS.DOC < prev    next >
Text File  |  1996-07-09  |  12KB  |  235 lines
  1.  
  2.  
  3.  
  4.               Zchess System Configuration Example
  5.     Zchess Version 1.8
  6.     February 11, 1996
  7.  
  8.     This is an example configuration for Zchess specifically for Synchronet
  9.     BBS, DIGITAL DYNAMICS.  If you wish to try Synchronet on a shareware
  10.     basis, you can get a copy from the SBBS support BBSes listed for
  11.     Zchess.  While I do not personally run a BBS, I have set a few of them
  12.     up for the purpose of developing doors.  I have found that Synchronet
  13.     was easy to use by both the sysop and the user.  You can purchase SBBS
  14.     from the following address:
  15.  
  16.     Digital Dynamics
  17.     PO Box 501, Yorba Linda, CA 92686
  18.     (714) 529-6328 Voice
  19.     (714) 529-9721 FAX
  20.  
  21.  
  22.     The Zchess chess door system consists of the following executables:
  23.  
  24.  
  25.        ZCHESS.EXE
  26.        2PGN. EXE
  27.        IMPORT.EXE
  28.        MAINT.EXE
  29.        NETCHESS.EXE
  30.        SETUP.EXE
  31.  
  32.     Of these, a complete SBBS setup will include configuration for
  33.     ZCHESS.EXE for the door, ZCHESS.EXE for a notification logon event,
  34.     MAINT.EXE as a daily or weekly event, and NETCHESS.EXE twice, once for
  35.     OUTgoing messages and once for INcomming messages.    2PGN.EXE is
  36.     executed from either ZCHESS or MAINT, and normally won't have other
  37.     uses.  IMPORT.EXE is intended to be run by the sysop who is attempting
  38.     to make changes to the database.  SETUP.EXE is run by the sysop who is
  39.     making changes to the ZCHESS or NETCHESS configurations.
  40.  
  41.     The following setups represent one way that Zchess can be configured.
  42.     Each system may differ.  These screens were captured from the actual
  43.     configuration of an SBBS setup.
  44.  
  45.     NOTE:  For Synchronet BBS message transfer, please create the
  46.     first message for the sub from the BBS.  Netchess is not able
  47.     to create a sub from scratch.
  48.  
  49.  
  50.     ZCHESS As A Chess Door and It's Your Move Notifier:
  51.  
  52.  
  53. ░░░░╔═════════════════════╗░░░░╔═══════════════════════════════════════════╗░░░
  54. ░░░░║  External Programs  ║░░░░║       Games Online Programs       ║░░░
  55. ░░░░╠═════════════════════╣░░░░╠═══════════════════════════════════════════╣░░░
  56. ░░░░║ │Fixed Events      ║░░░░║ │ZCHESS                   ║░░░
  57. ░░░░║ │Timed Events      ║░░░░║ │ZCHESS NOTIFY                ║░░░
  58. ░░░░║ │Global Swap List   ║░░░░║ │                       ║░░░
  59. ░░░░║ │Ext╔════════════════════╚═══════════════════════════════════════════╝░░░
  60. ░░░░║ │Onl║              Games Program Section             ║░░░░░░░░░
  61. ░░░░╚═════╠══════════════════════════════════════════════════════════╣░░░░░░░░░
  62. ░░░░░░░░░░║ │Name            Games                 ║░░░░░░░░░
  63. ░░░░░░░░░░║ │Internal Code        GAMES                 ║░░░░░░░░░
  64. ░░░░░░░░░░║ │Access Requirements                     ║░░░░░░░░░
  65. ░░░░░░░░░░║ │Available Online Programs...                 ║░░░░░░░░░
  66. ░░░░░░░░░░╚══════════════════════════════════════════════════════════╝░░░░░░░░░
  67. ░░░░╔═══════════════════════════════════════════╗░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  68. ░░░░║           Online Program Sections        ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  69. ░░░░╠═══════════════════════════════════════════╣░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  70. ░░░░║ │Main                    ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  71. ░░░░║ │Games                    ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  72. ░░░░║ │                     ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  73. ░░░░╚═══════════════════════════════════════════╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  74.  
  75.     The Chess DOOR can be configured as given below.  Zchess uses only
  76.     DOOR.SYS drop files.  Also, Zchess was not developed with SBBS's XTRN
  77.     libraries.    As such, it has it's own communications routines.  You must
  78.     configure SBBS to NOT intercept I/O interrupts.  It is not essential to
  79.     force the system to change directories to Zchess, as Zchess will be
  80.     able to find all of its subdirectories based on the location of the
  81.     executable.  Zchess is always a multi-node chess door.  If your BBS is
  82.     multinodal, configure the Multiple Concurrent Users as YES.  If you
  83.     have only a single node version of Zchess, but have a multi-tasker
  84.     available and would like to play chess againt remote callers, you may
  85.     either run Zchess in a separate window using \ZCHESS\LOCAL.BAT.
  86.     Alternatively, you may share a session with a user while playing games
  87.     by pressing F6 after the user enteres a Game.
  88.  
  89. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  90. ░░░░╔═════╔══════════════════════════════════════════════════════════╗═════╗░░░
  91. ░░░░║  Ext║                 ZCHESS                 ║       ║░░░
  92. ░░░░╠═════╠══════════════════════════════════════════════════════════╣═════╣░░░
  93. ░░░░║ │Fix║ │Name            ZCHESS                 ║       ║░░░
  94. ░░░░║ │Tim║ │Internal Code        ZCHESS                 ║       ║░░░
  95. ░░░░║ │Glo║ │Start-up Directory     C:\ZCHESS             ║       ║░░░
  96. ░░░░║ │Ext║ │Command Line        ZCHESS %f             ║═════╝░░░
  97. ░░░░║ │Onl║ │Clean-up Command Line                     ║░░░░░░░░░
  98. ░░░░╚═════║ │Execution Cost        None                 ║░░░░░░░░░
  99. ░░░░░░░░░░║ │Access Requirements                     ║░░░░░░░░░
  100. ░░░░░░░░░░║ │Execution Requirements                     ║░░░░░░░░░
  101. ░░░░░░░░░░║ │Multiple Concurrent Users    Yes                 ║░░░░░░░░░
  102. ░░░░░░░░░░║ │Intercept I/O Interrupts    No                 ║░░░░░░░░░
  103. ░░░░░░░░░░║ │Swap BBS out of Memory    No                 ║░░░░░░░░░
  104. ░░░░╔═════║ │Modify User Data        No                 ║░░░░░░░░░
  105. ░░░░║      ║ │Execute on Event        No                 ║░░░░░░░░░
  106. ░░░░╠═════║ │BBS Drop File Type     (R) GAP        DOOR.SYS     ║░░░░░░░░░
  107. ░░░░║ │Mai║ │Place Drop File In     Node Directory             ║░░░░░░░░░
  108. ░░░░║ │Gam║ │Time Options...                         ║░░░░░░░░░
  109. ░░░░║ │   ╚══════════════════════════════════════════════════════════╝░░░░░░░░░
  110. ░░░░╚═══════════════════════════════════════════╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  111.  
  112.     The notifier provides a simple message is the user is active in chess
  113.     and has a move in one of his games.  Configuring zchess as a logon
  114.     event will remind players to visit the door.  If the user isn't active
  115.     in chess, or doesn't have a move, the notifier will be all but
  116.     invisible.
  117.  
  118. ░░░░╔═════╔══════════════════════════════════════════════════════════╗═════╗░░░
  119. ░░░░║  Ext║              ZCHESS NOTIFY              ║       ║░░░
  120. ░░░░╠═════╠══════════════════════════════════════════════════════════╣═════╣░░░
  121. ░░░░║ │Fix║ │Name            ZCHESS NOTIFY             ║       ║░░░
  122. ░░░░║ │Tim║ │Internal Code        ZCNOTIFY             ║       ║░░░
  123. ░░░░║ │Glo║ │Start-up Directory     C:\ZCHESS             ║       ║░░░
  124. ░░░░║ │Ext║ │Command Line        ZCHESS %f NOTIFY         ║═════╝░░░
  125. ░░░░║ │Onl║ │Clean-up Command Line                     ║░░░░░░░░░
  126. ░░░░╚═════║ │Execution Cost        None                 ║░░░░░░░░░
  127. ░░░░░░░░░░║ │Access Requirements                     ║░░░░░░░░░
  128. ░░░░░░░░░░║ │Execution Requirements                     ║░░░░░░░░░
  129. ░░░░░░░░░░║ │Multiple Concurrent Users    Yes                 ║░░░░░░░░░
  130. ░░░░░░░░░░║ │Intercept I/O Interrupts    No                 ║░░░░░░░░░
  131. ░░░░░░░░░░║ │Swap BBS out of Memory    No                 ║░░░░░░░░░
  132. ░░░░╔═════║ │Modify User Data        No                 ║░░░░░░░░░
  133. ░░░░║      ║ │Execute on Event        Logon                 ║░░░░░░░░░
  134. ░░░░╠═════║ │BBS Drop File Type     (R) GAP        DOOR.SYS     ║░░░░░░░░░
  135. ░░░░║ │Mai║ │Place Drop File In     Node Directory             ║░░░░░░░░░
  136. ░░░░║ │Gam║ │Time Options...                         ║░░░░░░░░░
  137. ░░░░║ │   ╚══════════════════════════════════════════════════════════╝░░░░░░░░░
  138. ░░░░╚═══════════════════════════════════════════╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  139.  
  140.     The example above allows the notifier to be run as an external program
  141.     as well.  If the Execute on Event flag is changed to Logon, Only, it
  142.     will not appear in the External programs menu.
  143.  
  144.     Note that for both the ZCHESS and the NOTIFIER, you want to try to run
  145.     without swapping the BBS out of Memory if at all possible.    This will
  146.     save some time when starting and exiting the door.    I am able to run
  147.     ZCHESS in a DesqView window with about 300K memory available.  If you
  148.     can't provide this much memory without swapping SBBS out, then you
  149.     don't have a choice.  You might wish to consider not using the notifier
  150.     in this case, as users often dislike unnecessary delays during login.
  151.  
  152.  
  153.  
  154.     Timed Maintenace Events
  155.  
  156.     NETCHESS and MAINT should be configured as timed events.  NETCHESS will
  157.     be available for version 2.0 and above.  Those registering Zchess 1.8
  158.     and above now will be allowed to Beta test NETCHESS now if they so
  159.     choose.
  160.  
  161. ░░░░╔═════════════════════╗░░░░╔═══════════════════════════════════════════╗░░░
  162. ░░░░║  External Programs  ║░░░░║        Timed Events           ║░░░
  163. ░░░░╠═════════════════════╣░░░░╠═══════════════════════════════════════════╣░░░
  164. ░░░░║ │Fixed Events      ║░░░░║ │MSGMAINT    %!smbutil mp500 *.shd ..\ma║░░░
  165. ░░░░║ │Timed Events      ║░░░░║ │ZCNETOUT    NETCHESS.EXE OUT       ║░░░
  166. ░░░░║ │Global Swap List   ║░░░░║ │ZCNETIN    NETCHESS.EXE IN        ║░░░
  167. ░░░░║ │External Editors   ║░░░░║ │ZCMAINT    MAINT.EXE           ║░░░
  168. ░░░░║ │Online Programs      ║░░░░╚═══════════════════════════════════════════╝░░░
  169. ░░░░╚═════════════════════╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  170. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  171.  
  172.     For this example NETCHESS.EXE is used twice in the Timed Events
  173.     list.  It can be configured for a single event by NOT adding the
  174.     commandline switches of OUT or IN.    Netchess, if not restricted,
  175.     with then do all of the processing for incomming messages, then all
  176.     of the processing for outgoing messages.  Its used twice here to
  177.     accomodate the following sequence of events:
  178.  
  179.     1.    NETCHESS OUT is called just after midnight, creating messages that
  180.     will be retrieved by BBSes calling in during the night.
  181.  
  182.     2.    BBSes call in between 2:00 AM and 5:00 AM, retrieve their messages
  183.     and post new ones.    The messages of course are created by ZCHESS, and
  184.     contain the  moves for the games.
  185.  
  186.     3.    NETCHESS IN is called after 6:00 AM.  Messages left by other BBSes
  187.     are found, and games are updated.  No new messages are created since
  188.     players have not yet had a chance to move.
  189.  
  190.     4.    MAINT.EXE is called after NETCHESS IN.    This performs any
  191.     maintenance required, rebuilds that data base, and keeps everything
  192.     fresh.
  193.  
  194.     Note that it might be propper to call netchess with no switches
  195.     instead of NETCHESS OUT.  Should there be any updates to games in the
  196.     database, it might prevent unnecessary game reporting.  This timing
  197.     depends on what BBSes call, act as a hub, the frequency of calls, etc.
  198.     so your configuration will likely be a bit different to optimize
  199.     communications.
  200.  
  201.  
  202. ░░░░╔═════════════════════╗░░░░╔═══════════════════════════════════════════╗░░░
  203. ░░░░║  External Programs  ║░░░░║        Timed Events           ║░░░
  204. ░░░░╠═════════════════════╣░░░░╠═══════════════════════════════════════════╣░░░
  205. ░░░░║ │Fixed Events      ║░░░░║ │MSGMAINT    %!smbutil mp500 *.shd ..\ma║░░░
  206. ░░░░║ │Timed Events      ║░░░░║ │ZCNETOUT    NETCHESS OUT           ║░░░
  207. ░░░░║ │Global Swap List   ║░░░░║ │ZCNETIN    NETCHESS IN           ║░░░
  208. ░░░░║ │External Editors   ║░░░░║ │ZCMAINT    MAINT.EXE           ║░░░
  209. ░░░░║ │Online Programs      ║░░░░╚═══════════════════════════════════════════╝░░░
  210. ░░░░╚═════════════════════╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  211. ░░░░░╔════════════════════════════════════════════════════════════════════╗░░░░
  212. ░░░░░║                  ZCNETOUT Timed Event              ║░░░░
  213. ░░░░░╠════════════════════════════════════════════════════════════════════╣░░░░
  214. ░░░░░║ │Internal Code            ZCNETOUT              ║░░░░
  215. ░░░░░║ │Start-up Directory        C:\ZCHESS              ║░░░░
  216. ░░░░░║ │Command Line            NETCHESS.EXE OUT          ║░░░░
  217. ░░░░░║ │Execution Node            1                  ║░░░░
  218. ░░░░░║ │Execution Days            Sun Mon Tue Wed Thu Fri Sat      ║░░░░
  219. ░░░░░║ │Execution Time            01:00                  ║░░░░
  220. ░░░░░║ │Requires Exclusive Execution    No                  ║░░░░
  221. ░░░░░║ │Force Users Off-line For Event    No                  ║░░░░
  222. ░░░░░╚════════════════════════════════════════════════════════════════════╝░░░░
  223.  
  224.     NETCHESS is started sometime after users stop calling in.  It is run
  225.     daily.  This configuration does not require exclusive access.  Note,
  226.     however, if you have a user on another node who is playing ZCHESS,
  227.     NETCHESS will pause this node until the user finishes, with a limit of
  228.     fifteen minutes.  If NETCHESS is not able to monopolize the ZCHESS
  229.     system ( including ZCHESS.EXE, MAINT.EXE and other copies of
  230.     NETCHESS.EXE), the output for that night will not be generated.  See
  231.     ZCHESS.DOC for information about how system monopolies are enforced.
  232.  
  233.  
  234.  
  235.